Skip to content

Improve CLI troubleshooting for AI type/frontmatter issues#214

Open
yejiming wants to merge 1 commit intonextlevelbuilder:mainfrom
yejiming:jimmy/2026-03-29-06-53-07
Open

Improve CLI troubleshooting for AI type/frontmatter issues#214
yejiming wants to merge 1 commit intonextlevelbuilder:mainfrom
yejiming:jimmy/2026-03-29-06-53-07

Conversation

@yejiming
Copy link
Copy Markdown

Summary

This PR addresses issue reports around:

What changed

  1. Improved invalid AI type error guidance

    • Added a shared printInvalidAITypeError() helper in cli/src/index.ts.
    • Updated init, update, and uninstall command validation paths to use it.
    • Error output now includes explicit upgrade guidance:
      • uipro --version
      • npm install -g uipro-cli@latest
      • retry command
  2. Added CLI troubleshooting docs

    • Added troubleshooting section in cli/README.md for:
      • Invalid AI type: trae/droid
      • RooCode/Kiro frontmatter regeneration steps
    • Added matching troubleshooting section in root README.md for quick visibility.
  3. Added platform config verification script

    • New script: cli/scripts/verify-platform-configs.mjs
    • Verifies:
      • trae and droid are present in cli/src/types/index.ts
      • roocode and kiro platform configs contain non-empty frontmatter (name, description)
    • Added npm script:
      • verify:platform-configs in cli/package.json

Testing

  • npm --prefix cli run verify:platform-configs
  • npm --prefix cli run build
  • node cli/dist/index.js init --ai not-real

Related Issues

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant